home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / cpp_libs / intrvews / xhyper.lha / XHyper_v1.1 / sampledoc / section1.mml < prev    next >
Text File  |  1993-01-13  |  3KB  |  81 lines
  1. <MML 1.00 -- Sample.mml   A sample mml file>
  2.  
  3. <Comment *** Define paragraphs and fonts tags>
  4. <Include "Formats.mml">
  5.  
  6. <Comment *** Start of Document Text ***>
  7. <Title>
  8. Advanced On-Line Help System
  9.  
  10. <Section>
  11. 1.0 Introduction
  12.  
  13. <Body>
  14. No highly interactive system is complete unless it is fully documented, 
  15. complete with "On-line Help", available while the system is operating, 
  16. in addition to "Off-line Help" (i.e. User's Manual's). Proper 
  17. documentation can greatly ease the learning curves associated with 
  18. systems, reducing cost to the end-users in the form of labor and 
  19. productivity. This in turn may reduce cost to the developers in
  20. the form of reduced customer support.  With the acceptance of 
  21. the <hyper  XWindows> X Window System <endhyp> and in turn OSF/Motif 
  22. there has been a great deal of research and development in the 
  23. areas of Graphical User Interfaces (GUIs). However, very little has 
  24. been done with respect to the integration 
  25. of "Help" and documentation of these system.  In this project, I 
  26. performed the initial development of an X based on-line help
  27. system , <bold>XHyper<plain>, which features:
  28.  
  29. <Body>
  30. 1. Multiple fonts and highlighted text.\n
  31. 2. Paragraph formating and justification.\n
  32. 3. Integration of figures.\n
  33. 4. Hypertext.\n
  34. 5. On line help stored in Maker Markup Language format.\n
  35.  
  36. <Body>
  37. <bold>XHyper<plain> is written in C++ and utilizes the 
  38. <hyper InterViews> InterViews <endhyp> package developed by 
  39. Stanford University.
  40.  
  41. <Section mml>
  42. 1.1 Maker Markup Language
  43.  
  44. <Body>
  45. On of the most popular and powerful desktop publishing systems available 
  46. today is FrameMaker. FrameMaker is particularly powerful since it operates 
  47. on Unix work stations under the <hyper XWindows>X Window System<endhyp>. 
  48. FrameMaker files are stored in a very complex internal format. However, 
  49. to allow users to update documents from other word processors or text 
  50. editors, FrameMaker supports a the Maker Markup Language (MML). 
  51.  
  52. <Figure "test.ips">
  53.  
  54. <Body>
  55. The MML files are text files which 
  56. describe the format of the document in addition to it's contents.
  57. Since the MML is very broad, this phase of development 
  58. of <bold>XHyper<plain> supports a small subset of the MML 
  59. with extensions for figures and <hyper Hypertext>hypertext<endhyp>.
  60.  
  61.  
  62. <Section InterViews>
  63. 1.2 InterViews
  64.  
  65. <Body>
  66. InterViews is a software system for X window-based applications. 
  67. InterViews comes from the idea of a user interface object presenting 
  68. an interactive view of some data (Linton, et al). For 
  69. example, <bold>XHyper <plain>implements an interactive view of 
  70. <hyper MML> MML <endhyp> based help files. The InterViews 
  71. package contains a set of libraries containing a large variety of C++ 
  72. classes built on top of The <hyper XWindows>X Window Library (xlib)<endhyp>. 
  73. The most recent release of InterViews, version 3.0, contains a new base 
  74. class, Glyph. Appendix I contains a detailed description of Glyphs 
  75. and provides examples 
  76. from which XHyper evolved. Figure 2 illustrates the relation of InterViews 
  77. with res pect to the Xlib and applications. Note that the applications 
  78. DO NOT access the Xlib directly as to Xt based applications.
  79.  
  80.  
  81.